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About This Guide 


Purpose 


This guide is one of a series designed to instruct and guide you in the use of Operating 
System/3 (OS/3). This guide specifically describes how to make the transition from a 
Series 90 (90/25, 90/30, 90/30B, and 90/40) or System 80 (models 3 through 6, 7E, 

and 8) to a System 80 model 10, 15, or 20. It is intended for Series 90 users and 
System 80 users who are making the transition to OS/3 Release 14 on the models 10 
through 20. 


Scope 


The transition to models 10 through 20 is a straightforward process that can be 
accomplished with little difficulty. This guide provides all the procedures that are 
part of the transition process. Some of these procedures must be performed; others 

© are optional, depending on your current system. This guide offers examples, 
procedures, items for consideration, and suggestions and recommendations. Where 
appropriate, it provides detailed information on the facilities, along with references to 
other OS/3 documentation. 


Audience 


This guide is for site administrators and system programmers of Series 90 and 
System 80 OS/3 systems who are involved in the planning or actual execution of 
transition to models 10 through 20. 


Prerequisites 


Anyone using this guide should be familiar with OS/3 software, OS/3 software 
installation, system operations, and the concepts of communications networks. 
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About This Guide 


Organization 


vi 





This guide is divided into two parts. 
Part 1. Migration from Series 90 to Models 10 through 20 


This part consists of Sections 1 through 6, which provide the information you need to 
make the transition from a Series 90 system to System 80 models 10 through 20. 


Section 1. Series 90 Migration Overview 


Presents an overall look at the migration process and provides guidelines to aid you in 
planning your transition to models 10 through 20. 


Section 2. System Generation 


Describes the changes that you may want to make to your current system generation 
parameter set to make it conform to your new system configuration. 


Section 3. Data Management 
Describes the process for moving the data files and program libraries from your 
current system to models 10 through 20. Also included are recommendations and 


considerations that relate to data management issues. 


Section 4. Language Products 





Describes the changes that you can make to your current language programs to run 
them on models 10 through 20. This section also provides information about the 
language conversion aids available from Unisys. 


Section 5. ICAM Migration 


Describes the changes you should make to your ICAM network generations and your 
communications user programs for them to run on models 10 through 20. 


Section 6. Data Base Products 
Presents the procedure to convert from single-thread to multithread IMS and to 


convert your action programs to consolidated data management. This section also 
lists the IMS configuration parameters supported for each release from 6.1.2 through 


14. Considerations for moving a DMS data base to models 10 through 20 are also 


presented. 
Part 2. Migration from System 80 to Models 10 through 20 


This part consists of Sections 7 through 12, which provide the information you need to 
make the transition from models 3 through 6, 7E, and 8 to models 10 through 20. 
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Section 7. System 80 Migration Overview 


Presents an overall look at the migration process and provides guidelines to aid you in 
planning your transition to models 10 through 20. 


Section 8. System Generation 


Describes the changes that you may want to make to your current system generation 
parameter set to make it conform to your new system configuration. 


Section 9. Data Management 

Describes the process for moving the data files and program libraries from your 
current system to models 10 through 20. Also included are recommendations and 
considerations that relate to data management issues. 

Section 10. Language Products 

Describes the changes that you can make to your current language programs to run 
them on models 10 through 20. This section also provides information about the 
language conversion aids available from Unisys. 


Section 11. ICAM Migration 


Describes the changes you should make to your ICAM network generations and your 
communications user programs for them to run on models 10 through 20. 


Section 12. Data Base Products 

Presents the procedure to convert from single-thread to multithread IMS and to 
convert your action programs to consolidated data management. This section also 
lists the IMS configuration parameters supported for each release from 6.1.2 


through 14. Considerations for moving a DMS data base to models 10 through 20 are 
also presented. 


Results 


After completing the procedures in this guide, you should have successfully migrated 
to your new system. 


Notation Conventions 


The following conventions are used in this guide: 
¢ Macroinstructions and operands are shown in uppercase letters. 


¢ User-supplied variables are shown in lowercase letters in format descriptions and 
in italics within the text. 
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® Default values are shaded. 
¢ Optional operands are enclosed in brackets. 


*® Braces enclose groups of operands from which you must choose one. 


Related Product Information 


vill 


Note: Throughout this guide, when we refer to another document, use the version 
that applies to the software level in use at your site. 


American Standard COBOL Technical Overview, 7002 3932 
BASIC Programming Reference Manual, UP-9168 

Consolidated Data Management Programming Guide, UP-9978 
Data Utilities Operating Guide, 7004 4516 

File Placement Analyzer (FIPLAN) Programming Guide, UP-9731 
General Editor (EDT) Operating Guide, 7004 4599 


Information Management System (IMS) System Support Functions 
Programming Guide, UP-11907 





Models 8-20 Installation Guide, 7004 5505 


Integrated Communications Access Method (ICAM) Communications Physical 
Interface (CPI) Programming Guide, UP-9746 


Integrated Communications Access Method (ICAM) Utilities Programming 
Guide, 7004 4565 


System Activity Monitor Programming Guide, UP-9983 

OS/3 Distributed Communications Processor Transition Guide, 7004 1677 
Release 14 System Release Announcement, 7004 1991 

Report Program Generator II (RPG II) Programming Guide, UP-8067 
1985 American Standard COBOL Technical Overview, 7002 3932 


COBTRN303 Operations Guide, 7002 7685 
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Section 1 
Series 90 Migration Overview 


1.1. General Considerations 


When you migrate from a Series 90 system to the models 10 through 20, you'll be 
surprised at how easy the transition is. This is because models 10 through 20 provide 
extensive software and hardware compatibility with your current Series 90 system 
(90/25, 90/30, 90/30B, or 90/40). 


Models 10 through 20 operate under the control of an enhanced version (Release 14) of 
the OS/3 software, the same operating system you use with your Series 90 system. 
(OS/3 Release 8.1 was the last release that supported Series 90.) OS/3 supports 
common programming languages, program products, and data storage methods. This 
lets you quickly move your applications to models 10 through 20. You can also use the 
same communications facilities on models 10 through 20, so you don’t have to redesign 
your online programs. And, many of your Series 90 peripheral devices, such as disk 
and tape units, are also compatible between systems. In many cases, you can simply 
move your programs and data files directly to models 10 through 20 and start 

& production immediately! 


OS/3 was modified in Release 14 to support the increased memory capacity provided 
by the model 50 processor. Therefore, some existing assembly language (BAL) 
applications (those that access or modify OS/3 internal data structures) may need to 
be modified. 


1.2. Migration Flowchart 


Figure 1-1 gives an overview of the migration process. We’ve made one assumption in 
this flowchart: that you'll carry your programs and data files to models 10 through 20 
on your Series 90 disk devices. (All the devices supported on models 10 through 20 are 
listed in 3.4.) Since most of your Series 90 disks can be used on the models 10 through 
20, this is the quickest and easiest way to migrate to your new system. Once Release 
14 is installed, you can simply mount your Series 90 disks on models 10 through 20 
and immediately begin generating your supervisors, ICAM networks, and IMS 
configurations. 
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However, if you decide to transfer your programs and data files to one of the larger 
capacity disks supported by models 10 through 20 (8417, 8470, 8494, or M9720), you 
must copy your programs and data files to temporary media, such as tape or diskette, 
on your Series 90 system. Then, you can load your programs and data files from the 
temporary media onto the new disk. Section 3 tells you how to move your data files to 
models 10 through 20; Section 4 discusses program migration. 


The flow chart shown in Figure 1-1 is simply a suggested plan. It gives you a general 
idea of what you must consider and points you in the right direction. Your exact plan 
of migration should be determined by your operational needs. 


1.3. Migration Aids 


Unisys provides several software aids to further simplify your migration effort. A 
description of you how to use these aids is provided later; for now, here’s a brief 
description of each: 


¢ DTFCDI301 


The DTFCDI301 converter program converts OS/3 Assembler source code from 
define the file (DTF) macrocode to OS/3 common data interface (CDI) macrocode. 
DTFCDI301 converts file descriptions and I/O macros so they can run in a 
consolidated data management (CDM) environment (see 4.6). 


¢ COBTRN303 





ANSI 1968 COBOL programs will run without change on models 10 through 20. 
However, to make use of the new features offered by CDM, it is recommended 
that you convert your existing data files to MIRAM and your ANSI 1968 COBOL 
programs to ANSI 1974 or ANSI 1985 COBOL. Unisys makes available to you the 
COBTRN303 program that converts ANSI 1968 COBOL source statements into a 
format acceptable as input to the ANSI 1974 COBOL compiler (see 4.2). 
Generally, ANSI 1974 COBOL source is acceptable to the ANSI 1985 COBOL 
compiler. 


e SFCVR 


The screen format conversion utility (SFCVR) converts Series 90 screen formats 
so they can be used on models 10 through 20. SFCVR lets you modify complete 
screen format libraries or individual screen formats either interactively or in 
batch mode (see 3.11). 
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Series 90 Migration Overview 


Generation includes 
SUPGEN and |/OGEN 
phases of SYSGEN. 
Select data management 
mode 


gaa 
CDI 


Update network definitions, 
recompile CUPs, and generate 
dedicated or global network. 


Recompile action programs. If 

using new models 10/20 features, convert 
single-thread IMS systems to 

multithread and convert applications 

that use BDM to use CDM. 


If not already using 

CDM, convert data files 

to MIRAM and recompile 
source programs to use CDM. 


Modify job control streams 
to specify new models 10/20 devices. 


Update screen formats (if 
created on release 7.1) and BEM 
EDT procedures. 


Use sample data files; run 
side by side with present system. 


Figure 1-1. Models 10 through 20 Migration Flowchart 
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1.4. An Approach to Migration 


14 


The best way to begin your migration is to plan it. We suggest you review Figure 1-1 
and then develop an outline of the steps you'll follow during your own migration. Here 
are some other guidelines to help you carry out a successful migration: 


1. 


Back up your system 


Be certain you have a current backup copy of your Series 90 SYSRES volume 
before you migrate to models 10 through 20. This is a standard precaution for 
moving to a new computer system. 


Use sample data files 


Use sample data files for program testing before you migrate all your data files to 
models 10 through 20. This lets you identify any potential problems that could 
destroy complete data files. 


Run applications side by side 


After you migrate to models 10 through 20, continue running jobs on your Series 
90 system while you test applications on the models 10 through 20. Parallel 
operation lets you thoroughly test your programs to models 10 through 20 while 
using your Series 90 system as a backup. This prevents testing procedures or 
problems from completely halting your DP operations. We can’t overemphasize 
the importance of running parallel production jobs. 


Remember, forward migration is supported. Backward migration is not. You 
cannot take a program that is compiled and linked on Release 14 and execute it 
on a release prior to Release 14. 


Don’t make changes during migration 


If possible, don’t make any changes or enhancements to your programs while 
migration is under way. If you must make changes, monitor them carefully. 


Have everything ready 

Plan everything you need for the migration before you begin. This includes 
personnel, facilities, documentation, system time, migration aids, and recording 
media. 


Update your documentation 


Remember to update your in-house documentation (operator instructions, run 
books, standing orders, and so forth) to reflect your new data processing system. 
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Section 2 
System Generation 


2.1. General 


There are physical differences between your Series 90 system and models 10 
through 20. Therefore, you must adjust models 10 through 20 system generation 
parameters before you can use Series 90 software on your new system. 


You can perform system generation (SYSGEN) on models 10 through 20 just as you do 
on Series 90. Models 10 through 20 support the SYSGEN dialog, which lets you 
generate supervisors interactively at a workstation. Or, if you prefer, you can use an 
editor to create a SYSGEN source module. Regardless of the method you use, all 
SYSGEN procedures are fully compatible between systems. 


We deliver a basic supervisor, SY$BAS, as part of the system control software. 
SY$BAS eliminates the need to perform a SYSGEN operation unless you have a 
specific reason to do so. If you require features not supplied by SY$BAS, you must 
generate a supervisor tailored to your own needs. The Models 8-20 Installation Guide, 
7004 5505, describes the procedures for generating a supervisor either interactively or 
in batch mode. 


2.2. Supervisor Configuration 


Models 10 through 20 offer several new SUPGEN parameters that are not available 
with your Series 90 system. In addition, many parameters you've used on your Series 
90 system have new default values on models 10 through 20. 


Table 2-1 lists SUPGEN parameters that are either new or have been changed since 
Series 90 Release 8.1. We've also provided a brief description of each parameter in the 
table; for more detailed descriptions, see the Models 8-20 Installation Guide, 

7004 5505. 
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System Generation 


Parameter 





CHAN 


CHAN] 


COMM1 


DMGTMODE 


FILELOCK 


IGNORESFT 


IORB 


IORB1 


JCREADWKS 


TRNWKAREA 


INTMEM 


ISWORKn 


JOBMEM 


MAXJOBS 


Table 2-1. New or Changed SUPGEN Parameters 


Description 
Specifies input/output microprocessor (IOMP) channel number. 


Specifies second input/output microprocessor (IOMP) channel 
number. 


Specifies if ICAM network interfaces with communications 
terminals or only workstations when system supports two IOMP 
channels. 

Specifies type of data management support. 

Specifies which files are lockable. 


Specifies whether system ignores // SFT statements. 


Specifies number of input/output resource blocks (IORBs) to be 
generated for the channel. 


Specifies number of input/output resource blocks (IORBs) to be 
generated for the second channel. 


Specifies whether workstatior-initiated commands (RU, Fl, and Sl) 
can read be from the card reader. 


Specifies whether the system generates a 32K to 125K transient 
work area to keep most recently used transient modules in main 
storage. 


Specifies percentage of available main storage allocated for 
interactive services use. 


Allows interactive services work volume specification that 
controls where EDT, ESCORT, and BASIC work files are 


allocated. 


Specifies percentage of available main storage allocated for job 
use. 


Specifies maximum number of job slots. 








New or Changed 
in Release 


8.2 


8.2 


8.2 


8.2 


8.2 


8.2 


8.2 


8.2 





8.2 


8.2 


9.0 


9.0 


9.0 


9.0 





2-2 


continued 





7004 4631-000 


System Generation 








Parameter 


MAXRUNSYMBS 


MAXSWSJOBS 


MAXWSJOBS 


RESMGT 


SPOOLING 


SYSMBMEM 


CACHESEGSIZE 


CONALARM 


DDPSC 


DMRECV 


EXECPRI 


PASSWORD 


WAVR 


IMVJOB 
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Table 2-1. New or Changed SUPGEN Parameters (cont.) 


Description 


Specifies maximum number of run symbionts that can be 
executed concurrently in the system. 


Specifies maximum number of jobs initiated from a single 
workstation that can run concurrently in the system. 


Specifies maximum number of jobs initiated from workstations 
that can run concurrently in the system. 


Enables resource management capabilities. 
Specifies spooling. 


Specifies percentage of available main storage allocated for 
symbiont use. 


Specifies number of 1024-byte blocks in a CACHE segment. 


Specifies whether to sound an audible alarm when an action or 
reply message is sent to the system console. 


Specifies whether host ids are checked as part of a user’s 
identity when the user enters a command into the system from a 
remote host. 

Creates IRAM/MIRAM files with recover option. 


Allows user-specified job step processor execution priority. 


Specifies whether all users are required to enter a password to 
log on. 


Indicates whether automatic volume table of contents (VTOC) 
verification is performed at automatic volume recognition (AVR) 
time. 


Allows relocation (shuffle) of immovable jobs to utilize locations 
more efficiently. 


New or Changed 


in Release 


9.0 


9.0 


9.0 


9.0 
9.0 


9.0 


10.0 


10.0 


10.0 


10.0 


10.0 
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Table 2-1. New or Changed SUPGEN Parameters (cont.) 





Parameter 


MEMCON 


MIRAMCHAR 


ALTJCS 


EXPBFCTSZ 


ISWKSBUL 


ISWKSLOG 


RESBFCTSZ 


SYMBIONT 


IGNJCERR 


SCRATCHDVC 


SPOOLTPBUFR 


TAPEAVR 


ISETNAME 


PRIORITY 


Description 


Allows execution with or without job consolidation when free 
storage space is available. 


Indicates that newly created MIRAM files are created as MIRAM 
characteristic files. 


Identifies the file that is to be the system default for the alternate 
SYSJCS library. 


Specifies the maximum number of dynamic buffer control blocks 
(DBCB) that can be dynamically allocated at any one time if the 


resident control block becomes full. 


Specifies the values that control display of the interactive 
services BULLETIN when a user logs on. 


Specifies the values that control the interactive services LOG file 
for each user that logs on. 


Specifies the maximum number of dynamic buffer control blocks 
for which resident storage space is set aside. 


Assigns a specific priority to a specific symbiont. 
Suppresses job control error messages. 
Specifies the default location of the WORK and TEMP files. 


Specifies the size of the buffer to be used to generate the tape 
block in 256-byte increments. 


Inhibits tape automatic volume recognition (AVR) during system 
initialization when NO is specified. 


Parameter is no longer applicable. If specified, it is ignored. 


Parameter now defaults to 8. 


New or Changed 


in Release 


11.0 


11.0 


12.0 


12.0 


12.0 


12.0 


12.0 


12.0 
13 
13 


13 


13 


13 
14 


continued 
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Table 2-1. New or Changed SUPGEN Parameters (cont.) 


Parameter 


EXECPRI 


SYMBPRI 


SPOOLMAXREC 


SPOOLMAXLINE 


SYSLOG 


CONALARM 


Y/OGEN (PRINTER) 


VOGEN (DISK and 
TAPE) 


/OGEN (DISK and 
TAPE) 


JOBSLOTS 


RESMOD 


7004 4631-000 


‘Description 


Parameter defaults to one less than the PRIORITY value (one 
minimum). 


Parameter defaults to one of the following values: 

- If PRIORITY is 8 or less, the default is three less than that value 
(zero minimum). 

- lf PRIORITY is 9 or more, the default is 5. 


Causes the |/OGEN PRINTPOS parameter to be ignored for all 
printers. Allows a print line of up to 224 bytes. 


Option 0 is added (specifies no limit on the number of records 
that can be entered in the spool file). 


ACT, LOG, and WS options are added. They allow selective 
accumulation of Accounting, Log, and Workstation record types 
W and R. 


ONE option is added. It causes a single alarm to sound when an 
action or reply message is sent to the console. 


Up to 250 virtual printers can be specified. 


DOWN parameter is added. It allows a device to be marked down 
in the supervisor. The default is DOWN=NO. 


READONLY parameter is added. It allows a device to be marked 
as read-only in the supervisor. The default is READONLY=NO. 


Parameter defaults to 24. 


Parameter is no longer applicable. The associated software 
modules are always resident. 


New or Changed 
in Release 


14 


14 


14 


14 


14 


14 


14 


14 


14 
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Table 2-1. New or Changed SUPGEN Parameters (cont.) 





New or Changed 
Parameter Description in Release 
DCPCHNL Up to four DCP channels can be specified. 14 
RESMGT Must be specified to allow use of all LIMITS command 14 
parameters except MAXLOGONS and UPTERMINAL. Must not be 
specified if SINTLMT and ISBATCHLIMIT are changed from their 
default values. 
ISLOGONSC Must be specified to allow MAXLOGONS and UPTERMINAL 14 
parameters to be used with the LIMITS command. 
TRANS Parameter defaults to 15. 14 
VOLTABLE Parameter is no longer applicable. The volume table is always 14 
resident. 
SCDINDEX Parameter defaults to YES. 14 
IGNORESFT Parameter defaults to YES. 14 
ALTJCS An option is added (,S) to continue the search in SYSJCS when a 14 
job is not found in the alternate library. 
RESBUFSIZE Parameter defaults to 800. 14 
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® 2.3. 1/0 Configuration 


Models 10 through 20 support channel addresses that are different from those 
supported on your present system. The channels supported on models 10 through 20 
are channels 1 through 6 and 12 through 15. Channels 1 through 6 are selector 
channels, and channel 1 has the highest priority. If you have job control streams that 
use explicit channel addresses on their DVC statement, you will have to change the 
channel address information on the DVC statements so that they conform to the 
channel address assignments for models 10 through 20. 


2.4. 8418 Disk Support 


The 8418 disk cannot be used as a SYSRES device on models 10 through 20. The 
relatively small capacity of the 8418 disk can cause sizing problems. The addition of 
new products to OS/3, as well as the increasing size of existing products, makes it 
difficult to fit everything onto an 8418 disk. By not allowing the 8418 disk to be used 
as a SYSRES device, we’ve eliminated potential sizing problems. 


2.5. Plateau Control 


Models 10 through 20 use plateau control. This provides coordination between the 
different levels of the hardware, software, microcode, and microcode products. See the 


Release 14 System Release Announcement, 7004 1991, for additional information on 
e plateau control. 
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Section 3 
Data Management 


3.1. General 


As we explained in Section 1, models 10 through 20 are designed to operate primarily 
under CDM. CDM supports many new, interactive features such as screen format 
services, dialog processor, EDT, and enhanced workstation support. To use these 
features, you must convert the disk data files they use to MIRAM format. 


In this section, we'll provide guidelines so you can decide which files you should 
convert and show you how to convert those files to MIRAM. 


3.2. Media Considerations 


Your data files can reside on a variety of media: disks, tapes, diskettes, and cards. 
However, only your disk data files must be converted to MIRAM. All tape, diskette, 
and card data files are compatible with both BDM and CDM, so you don’t have to 
convert these files. Table 3-1 lists each type of media and shows which are supported 
by BDM and which are supported by CDM. We’ve broken down the disk media 
category into subcategories representing each type of disk file. As you can see, CDM 
supports MIRAM, IRAM, and SAT characteristic files only. All other disk data files 
must be converted to MIRAM to use CDM. 


Table 3-1. Media Support for BDM and CDM 


BDM Support 







CDM Support 





Tape Yes 
Diskette Yes 
Card Yes 
Disk 
MIRAM Yes 
TRAM Yes 
SAT Yes 
SAM No 
DAM No 
ISAM No 
ASAM No 
Workstation Yes 
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Most Series 90 users operate under basic data management (BDM). It uses the define 
the file (DTF) interface and supports the following file access methods: 


¢ MIRAM (multiple indexed random access method) 

e IRAM (indexed random access method) 

e SAT (system access technique) 

e SAM (sequential access method) 

¢ DAM (direct access method) 

¢ ISAM (indexed sequential access method) 

e ASAM_ (alternate sequential access method) 

Models 10 through 20, however, are designed to operate primarily under CDM. It is an 
enhanced version of data management that uses the common data interface (CDI) for 


all files. CDI supports just one file access method, MIRAM (and IRAM, a subset of 
MIRAM). 


3.3. Environments 


To ease your migration, models 10 through 20 support applications that use BDM as 
well as those that use CDM. This lets you run your current Series 90 programs on 
models 10 through 20 without changing those programs or the data files they use. On 
models 10 through 20, you choose your data management environment during 
SYSGEN by specifying one of two values for the DUGTMODE parameter: 





DMGTMODE=| MIXED 
cDI 


If you specify DMGTMODE=CDI, models 10 through 20 support CDM only; if you 
accept the default DUGTMODE=MIXED, models 10 through 20 support BDM and 
CDM. When you operate in mixed mode, models 10 through 20 are fully compatible 
with your Series 90 system at the load code level. A program that runs on Series 90 
using BDM can run on models 10 through 20 without change; a Series 90 program 
that uses CDM can also run on models 10 through 20 without change. You should 
select the environment that matches your current Series 90 environment. If you are 
using the BDM-only environment, you should run in the mixed environment on 
models 10 through 20. 
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@ Models 10 through 20 have many advanced interactive facilities that use CDM 
exclusively. These facilities include screen format services (SFS), ESCORT™ 
programming language, dialog processor, the OS/3 general editor (EDT), and 
workstation support. While your existing applications can run on models 10 through 
20 without change, if you want to incorporate these new features into your 
applications, you must migrate from BDM to CDM. Basically, this involves converting 
your disk data files to MIRAM format and, in some cases, recompiling your programs. 
Here are some of the advantages MIRAM provides: 
e¢  Asingle access method for all file structures 
¢ Improved file access time 
¢ Multikey access 
* Record deletion 
¢ Higher degree of disk file sharing 
¢ Distributed data processing (DDP) remote file sharing 
Throughout this part we'll tell you how to convert various software features to CDM. 
Remember that we offer mixed-mode support primarily so you can continue using 


BDM applications after you migrate to models 10 through 20. Whenever possible, 
however, you should convert your programs and data files to run in a CDM-only 


} environment. 
3.4. Hardware Compatibility 


Many Series 90 peripheral devices are also supported on models 10 through 20. You 
can take many of your disks and tape devices as well as a variety of printers and card 
devices with you when you migrate. The following list shows the peripherals that are 
supported by models 10 through 20. 
¢ Disks 

8417, 8419, 8430, 8433, 8470, 8480, 8494, and M9720 


In addition, 8416 and 8418 disks can be used as data devices; however, they 
cannot be used as a SYSRES device. 


e §Diskettes 


8420 and 8422 


@ ESCORT is a trademark of Unisys Corporation. 


7004 4631-000 33 











Data Management 





Tapes 

UNISERVO® 10, 12, 14, 16, 20, 22, 24, 26, and 28 
Streaming tape and BT32xx tapes 

Printers 

0770, 0770 II, 0776, 0789, 0798, 9246-14B, and 9246-25B 
Card readers 

0716 and 0719 

Card punches 

0608 

Workstations 

Model 1 and Model 2 

SVT 1122 

Communications subsystems 

UTS 20, 30, 40, 400, and 4000 

SVT 1120, 1123, and 1124 


DCPs 


3.5. Support for 8470 Disk Units 


34 


The 8470 disk used on models 10 through 20 supports both BDM and CDM. Therefore, 
you don’t have to bring your Series 90 disks forward to run applications under BDM 
on the models 10 through 20. You can simply copy your Series 90 software to tape or 
diskette, load it onto an 8470 unit, and continue normal processing operations. 


UNISERVO is a registered trademark of Unisys Corporation. 
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3.5.1. Moving Files to the 8470 Disk 


The 8470 disk has much greater capacity than any Series 90 disk. Therefore, you may 
decide to move the contents of several Series 90 disks onto one 8470 disk. To increase 
system throughput and decrease response time, you should place heavily accessed 
files next to one another on the 8470 disk. To do this, you must first know your 
application environment and be able to identify those files you use most frequently. 


Series 90 users of Release 7.0.1 forward can use the system activity monitor (SAM) to 
provide detailed disk and file information. If you are migrating from Releases 7.0.1 or 
7.1, you can use SAM to identify heavily accessed Series 90 disks and those that have 
large average arm movements. For Release 8.0 forward, use SAM trace mode and the 
volume table of contents (VTOC) of your Series 90 disks to identify heavily accessed 
files on those disks. This data should help you determine the file placement to 
optimize load balancing and minimize disk arm movement. For more information 
about SAM, see the System Activity Monitor Programming Guide, UP-9983. 


Once you've migrated to models 10 through 20, you can use the file placement 
analyzer (FIPLAN) to determine optimum file placement. FIPLAN is a general 
purpose performance tool that uses SAM trace data as input and projects an optimized 
disk file allocation. You can then allocate files to provide balanced loading across disks 
and ensure reduced seek time (time spent searching for files) within each disk. For 
more information about FIPLAN, see the File Placement Analyzer (FIPLAN) 
Programming Guide, UP-9731. 


3.5.2. Effect of Sector Size on Performance 


The physical sector size of the 8470 disk is 1024 bytes, but data may be accessed in 
either 1024- or 256-byte increments; each 1024-byte sector can be treated as four 
logical 256-byte sectors. When you access the 8470 disk in 256-byte logical sector 
increments, additional I/O requests are incurred when: 


¢ The starting logical sector number does not fall on a 1024-byte physical sector 
boundary. 


¢ The number of bytes accessed is not a multiple of 1024. 


Because the 8470 disk provides access to files in 256-byte mode, you can create files 
and subsequently access them with your existing Series 90 application programs 
without modifying these applications. However, when you develop new applications or 
update existing ones, you may want to modify them to use the 1024-byte sector size by 
increasing the I/O buffer size specification to a multiple of 1024. The buffer size 
requirements differ for each file type (SAM, DAM, ISAM, or MIRAM) and record type 
(fixed or variable format) being used by an application program. You can calculate the 
minimum buffer size required for a given record size by substituting either 256 or 
1024 for the sector size variable. Refer to the Consolidated Data Management 
Programming Guide, UP-9978, for details on buffer sizing calculations for SAM, DAM, 
ISAM, and MIRAM files. 
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When you define file characteristics with a higher level language, the buffer size can @ 
be defined as a multiple of 1024: 


¢ InCOBOL, use the BLOCK CONTAINS clause to specify either the number of 
records in a logical block or the number of bytes in a logical block. 


¢ In RPG, use the BLOCKSIZE specification to define the number of bytes in a 
logical block. 


¢ In FORTRAN, use the unit definition to define a block size. 


By using a 1024-byte value for sector size in these calculations, you can specify an 
effective buffer size module of 1024. 


In general, accessing files in 1024-byte sector increments provides for the most 
efficient I/O operation, but may result in unused disk space. For example, an ISAM 
file with a 1200-byte block size requires two 1024-byte sectors per block, or 2048 bytes. 
If you access files in 256-byte sector increments, you can often save space but you may 
incur additional I/O requests. The same 1200-byte block size ISAM file requires five 
256-byte blocks, or 1280 bytes. Although you save 768 bytes (you use 1280 bytes 
instead of 2048) when you use 256-byte sector increments, you also require five I/O 
requests instead of two. 


Here are the accessing modes for the various file structures supported by the 8470 
disk: 





e = File formats 


You can maintain both system files and data files on the 8470 disk. System access 
technique (SAT), SAM, DAM, ISAM, and MIRAM files are all supported. 


e System files 


System files are maintained as SAT files and are based on a 256-byte sector 
format. The system access technique, and products that use SAT for logical I/O, 
use the 256-byte sector mode when accessing the 8470 disk. However, when 
multiple 256-byte blocks are accessed in one I/O and the I/O begins on a 1024- 
byte sector boundary, no performance loss occurs. 


¢ Data files 


SAM, DAM, and ISAM files use the 256-byte sector mode. These files define a 
block-size value that represents the physical size of a block containing one or 
more records. This block size cannot be modified once the file is created. However, 
when the specified block size is rounded up to the next 256-byte boundary and 
this figure is a 1024-byte multiple, I/O is performed in 1024-byte increments. 
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& MIRAM files are accessed in either 1024-byte or 256-byte sector mode, depending 
on the size of the I/O buffer available in the application. If the application 
provides a buffer that is a multiple of 1024 and the buffer size is adequate to 
process records in 1024-byte sector increments, MIRAM performs read/write 
operations in 1024-byte increments. Otherwise, MIRAM performs read/write 
operations in 256-byte sector increments. In either mode, MIRAM records span 
sectors as necessary; no space is left unused between logical record slots. 


3.6. Support for 8494 and M9720 Disk Units 


The 8494 and M9720 disks support BDM and CDM and all existing file structures 
(SAM, DAM, ISAM, IRAM, SAT, and MIRAM). The guidelines for moving your Series 
90 software to the 8494 or M9720 disks is basically the same as that documented for 
the 8470 disk (3.5.1.). 


The effect of sector size on performance is also the same as that documented for the 
8470, taking into account that the sector size for the 8494 and M9720 is 512 bytes 
versus 1024 bytes for the 8470 disk (3.5.2). 


Also take note when calculating disk space requirements for MIRAM files on the 8494 
and M9720 disks that the track capacity of 96 sectors per track applies to both data 
and index partitions. 


& 3.7. Data Utilities 


We provide a program, the OS/3 data utilities, that lets you move your disk data files 
to models 10 through 20 and convert them to MIRAM. All data utility job control 
streams are upward compatible from Series 90 to models 10 through 20 Release 14. 
Thus, you can use data utilities to transfer your data files between peripheral devices 
(disk, tape, and diskette) either on Series 90 or on models 10 through 20. You can also 
use data utilities to reformat your data files to your own specifications on either 
system. 


The data utilities program can be run in either batch or interactive mode. Interactive 
data utilities defaults to MIRAM for all output disk files; also, you don’t need to 
include job control statements when you run interactive data utilities since all devices 
are assigned in the dialog. You may not be familiar with interactive data utilities 
(which is supported only for Release levels 7.1 forward), so we'll describe it briefly. 


To use interactive data utilities, you key in RV I@DATA at your workstation. A series 
of questions in dialog format is then displayed on your workstation screen. Your 
answers to these questions specify which files you want to copy or reformat. If you 
don’t understand a question, you can display a help screen that further defines the 
question. After you have answered all the questions, the DATA routine begins 
processing. 
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Regardless of whether you use data utilities in interactive or batch mode, this routine 
lets you copy your disk data files to tape or diskette on your Series 90-system. Then, 
you can load your data files to an 8470, 8494, or M9720 disk and reformat the data 
files, again using data utilities. Figure 3-1 illustrates this process. 






SERIES 90 
SYSTEM 


DATA UTILITIES 










SYSTEM 80 
MODELS 10/15/20 
DATA UTILITIES 


A19143 


Figure 3-1. Copying Data Files Using Data Utilities 
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@ 3.8. MILOAD Utility 


You may want to use the utility program MILOAD when transferring your data files 
to models 10 through 20. MILOAD can significantly increase performance when you 
reformat large, multikeyed MIRAM files. MILOAD supports input files on tape 
(created by OS/3 in EBCDIC mode) or on disk (MIRAM format). The output file 
created by MILOAD is always a MIRAM characteristic file. See the Data Utilities 
Operating Guide, 7004 4516, for more information on how to use MILOAD. 


3.9. Vancouver Utilities 


3.10. 


System 80 Vancouver Utilities (S80-VAN) is a set of utility programs that can be used 
to simplify the transfer of data files to models 10 through 20 via magnetic tape. 


Disk File Sharing 


CDM file sharing is different from BDM file sharing. To understand this, the term 
lockable file must be defined. A lockable file is protected by data management. It is 
protected in the sense that data management guarantees that the manner in which a 
program intends to access a file is consistent with any other programs that are already 
accessing the file. For example, if a program has exclusive use of a file, no other 
programs can access that file. If a file is not lockable, data management does not 
provide this protection. To summarize: 


¢ Under CDM, all files are lockable. Data management protection is always 
provided when accessing a file under CDM. 


¢ Under BDM, you have some control over file locking via the FILELOCK SYSGEN 
parameter. The default, SHARE, specifies that all files are lockable. However, 
you can specify YES, which indicates that only files whose physical file name 
(LBL) starts with $Y$ or $LOK are considered lockable. On Series 90, the NO 
specification is supported. It is not supported on models 10 through 20. 


Under CDM, there is support for facilities that was not available under BDM: 


¢ When a file is being shared between a writer and a reader, the reader has access 
to all the records that are added by the writer. Under BDM, the added records are 
not accessible. 


¢ The problems that you encountered (using BDM MIRAM) when a writer and 
reader were accessing an indexed file have been resolved under CDM. Under 
BDM, the reader could encounter DM24 errors or premature end-of-file 
conditions when reading through a file. 


* CDM supports multiple writers sharing a file. There are some limitations to this 
support in an interactive (transaction processing) environment. However, in a 
batch environment, there are facilities that were previously not available to the 
BDM user. 
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The FILELOCK SYSGEN parameter that was mentioned earlier is used as follows on 
the models 10 through 20: 


e If you are using FILELOCK=YES or NO on your current system, specify 
FILELOCK=YES on the models 10 through 20. 


e Ifyou are using FILELOCK=SHARE on your current system, specify 
FILELOCK=SHARE on the models 10 through 20. 


Screen Formats 


You can move your existing Series 90 screen format libraries intact to models 10 
through 20. Series 90 screen formats created on release 8.0 are fully transportable to 
models 10 through 20 and can be run without change. If you are migrating from Series 
90 Release 7.01 or 7.1, you can also use your screens on your new system. But when 
you use Release 7.0.1 or 7.1 screens, models 10 through 20 screen format coordinator 
must convert each screen each time the screen is read into main storage. We 
recommend that, whenever possible, you convert your 7.0.1 or 7.1 screens to meet 
models 10 through 20 requirements. (Use the screen format converter utility to assist 
you with the conversion.) 


We provide a utility program, the screen format conversion utility (SFCVR), that 
converts Release 7.0.1 or 7.1 screens so they are compatible with models 10 through 
20. SFCVR takes these screens and reworks them into a format acceptable to the 
models 10 through 20 screen format coordinator. You can run SFCVR either in batch 
mode or interactively, simply by entering the following command: 


RV SFCVRL,,I=Y] 
where: 


1=Y 
Specifies that you are running SFCVR interactively. 


Additional keyword parameters let you specify which files or libraries you want to 
convert. Of course, you can also specify where the converted output is to be stored. In 
most cases, you'll probably accept the following defaults when you run SFCVR: 


¢ Old screen formats are stored in $Y$FMT on your Release 7.0.1 or 7.1 SYSRES 
volume. 


¢ New (converted) screen formats are stored in $Y$FMT on your models 10 through 
20 SYSRES volume. 


Just as a precaution, we recommend that you back up and save your original screen 
formats before you use SFCVR. Store these formats in a library until your migration is 
complete. You'll find that SFCVR lets you modify a complete format library or 
individual format files quickly and simply. 
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4.1. General 


Your Series 90 programs are fully compatible with the models 10 through 20 at the 
load code level when equivalent functionality is available. Therefore, you can run most 
of your current programs on models 10 through 20 without making any changes to 
them. We recommend, however, that when you migrate to models 10 through 20, you 
convert any programs that use BDM to use CDM instead. As we explained in 1.3, you 
can’t incorporate any new models 10 through 20 features into your existing programs 
until you convert those programs to CDM. 


In this section, we tell you how to convert your Series 90 programs that use BDM so 
they can run on models 10 through 20 using CDM. We provide guidelines for 
converting programs written in each of the following languages: 


¢ COBOL 


@ ° FORTRANIV™ 


¢ Report Program Generator II (RPG II) 
¢ BASIC 

¢ Basic Assembly Language (BAL) 

¢ ESCORT Programming Language 


In most cases, you can obtain CDM support simply by recompiling your programs. All 
procedures for compiling programs are fully compatible between systems. That is, you 
can recompile (or convert and reassemble for BAL programs) your programs on 
models 10 through 20 just as you do on Series 90. And, since you can already run all 
your current programs on models 10 through 20 using mixed-mode support, you don’t 
have to recompile all your programs at once; instead, you can convert them at your 
convenience, according to your priorities and workicad. 


You may need to modify and reassamble some of your BAL programs (whether BDM 
or CDM) to run with OS/3 Release 14. See 4.6.4 for additional information. 





@ FORTRAN NV is a trademark of SuperSoft Associations. 
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4.2. COBOL (ANSI 1968 to ANSI 1974 or ANSI 1985) 





Your ANSI 1968 COBOL programs can run in mixed mode on models 10 through 20 
without change. However, CDM doesn’t support ANSI 1968 COBOL. Therefore, you 
may want to convert your ANSI 1968 COBOL programs to ANSI 1974 or ANSI 1985 
COBOL and then recompile those programs to run on models 10 through 20 under 


CDM. 


Unisys makes available the converter COBTRN303, which converts ANSI 1968 
COBOL source code to ANSI 1974 COBOL source code. COBTRN303 also flags (issues 
a diagnostic message for) any source statements that it cannot convert; you must 
convert these statements manually. COBTRN303 produces converted output that is 
acceptable to the ANSI 1974 COBOL compiler, except for those items that have been 
flagged. Except for SAM and ISAM ORGANIZATION clauses, the converted output of 


COBTRN303 is generally acceptable to the ANSI 1985 COBOL compiler. 


For more details on using COBTRN303, see the COBTRN303 Operations Guide, 
7002 7685. For more details on the differences between ANSI 1974 COBOL and ANSI 


1985 COBOL, see the 1985 American Standard COBOL Technical Overview, 
7002 3932. 


Here are some additional guidelines for converting ANSI 1968 COBOL to ANSI 1974 


or ANSI 1985 COBOL: 
1. Data file support 


¢ Converting to ANSI 1974 COBOL 





You must convert all direct access method (DAM) data files to MIRAM 
format, using OS/3 data utilities. We also recommend that you convert all 
SAM and ISAM data files to MIRAM, but this is necessary only if you specify 
DMGTMODESCDI in your supervisor. The ORGANIZATION clause in your 
COBOL program is automatically changed if you use COBTRN303. If you 
convert your COBOL source code manually, you must make the changes 


shown in Table 4-1. 


e Converting to ANSI 1985 COBOL 


You must convert all SAM, DAM, and ISAM files to MIRAM format, using 


OS/3 data utilities. You must also manually change the COBOL 
ORGANIZATION clause as shown in Table 4-1. 
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Table 4-1. Changes to ORGANIZATION Clause 


ANSI COBOL ORGANIZATION Clause 
1968 COBOL 1974 COBOL 1985 COBOL 









File 









DMGTMODE=MIXED | DMGTMODE=CDI 

















Sequential | SAM N/A Suppor ted Not supported 
DAM Relative N/A N/A Suppor ted Not supported 
ISAM Indexed ISAM N/A Suppor ted Not supported 


MIRAM | N/A Sequential, 
relative, 
or indexed 


Sequential, 
relative, 
or indexed 


Suppor ted Supported 








2. Features supported only by ANSI 1974 and ANSI 1985 COBOL 
¢ CDM 
‘ MIRAM data files 
¢ Workstations 
*  Reentrant IMS or TIP/30® action programs 
3. Main storage requirements 
ANSI 1968 COBOL is statically linked; ANSI 1974 and ANSI 1985 COBOL can 
be statically or dynamically linked and may require increased main storage 
allocation on the // JOB statement. 


4. Printer requirements 


ANSI 1968 COBOL directs SYSLST to the printer. ANSI 1974 and ANSI 1985 
COBOL direct SYSLST to the system log file. 


5. SEARCH ALL statement 
In ANSI 1968 COBOL, the indexed table item in the SEARCH ALL statement 
can be on either side of the equal sign (=) in the WHEN clause. In ANSI 1974 
COBOL, the indexed table item must be on the left side of the equal sign (=). 
6. Jobcontrol 


The // LFD filename,,EXTEND statement is not supported for MIRAM files. 
Instead, specify OPEN EXTEND when you open a MIRAM file in your program. 





TIP/30 is a registered trademark of Allinson-Ross Corporation. 
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4.3. FORTRAN IV 


To convert FORTRAN IV to CDM mode, you must recompile the FORTRAN IV 
programs (specify DUGTMODE=CDI during supervisor generation) and make the 
following changes: 


1. Converted all disk files to the MIRAM format. 


2. Reverse the order of the FORTRAN IV compiler macro and object modules on the 
SYSRES. Ifyou don’t place these modules in the proper order when using the 
FORTRAN IV compiler run-time modules, errors will result. 


There are two compiler macro modules in the system macro library ($Y$MAC) 
and two object modules in the system object library ($Y$OBJ). In each library, 
the first module (called DTF) only supports BDM while the second module (called 
MIX) supports both BDM and CDM. To support CDM, the MIX module must be 
repositioned so that it is first in each library. 


To reverse the FORTRAN IV modules, run the prefiled MIXFOR4 job control 
stream: 


RV MIXFOR4 


3. Reassemble unit definitions and relink object modules. 


Note: In CDM mode, specify the FDIAGNOSE=YES parameter only for a printer, 
not for a workstation. 





4.4. RPGIl 


Your BDM RPG II programs can run on models 10 through 20 in mixed mode without 
modification or recompilation. To convert your RPG II programs to CDM mode, you 
must recompile your programs (specify DMUGTMODE=CDI during supervisor 
generation), and change the disk data files your programs use to MIRAM format. 


In a mixed-mode environment, all disk file interfaces default to BDM. To generate 
CDM MIRAM interfaces, you must supply one of the following statements in the job 
control stream that executes the program: 


// PARAM MIRAM=file1,file2,...,filen 


or 


// PARAM MIRAM=ALL 
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where: 


filei,file2,...,filen 
Specifies which files are MIRAM; files not specified are accessed through 
BDM mode (specify DUGTMODE=MIXED during supervisor generation). 


ALL 
Specifies that all disk data files are MIRAM and are accessed in CDM mode 


(specify DMGTMODE=MIXED or DMGTMODE=CDI during supervisor 
generation). 


Note: These parameters are used only with disk data files. Other devices use CDM 
in both CDM and MIXED modes. 


The // PARAM MOD=IRAM statement used in Release 6.1.2 specifies that all IRAM 
files are accessed through BDM when you compile your programs in mixed mode. If 
you want your IRAM files accessed in CDM mode, replace the // PARAM MOD=IRAM 
statement with the // PARAM MIRAM=ALL statement. 


You compile your RPG II programs on models 10 through 20 just as you do on your 
Series 90 system. However, the RPG II compiler may require more main storage on 
models 10 through 20. If necessary, increase the main storage allocation on the // JOB 
statement of the job that compiles the program. For more details on using RPG II on 
models 10 through 20, see the Report Program Generator II (RPG II) Programming 
Guide, UP-8067. 


4.5. Basic Editor Monitor (BEM) 


BEM is not supported on models 10 through 20. BEM BASIC and BEM EDT 
functionality is provided by the interactive BASIC and EDITOR products. 


4.5.1. Editor (EDT) 


The editor (EDT) runs in either CDM or mixed mode and operates in essentially the 
same way as BEM EDT. However, there are some differences between the two editors. 
The following guidelines should help you convert your BEM EDT procedures to EDT 
with a minimum of difficulty: 


e File and record differences 


1. EDT can access SAT and MIRAM library files, MIRAM data files, spool files, 
sequential device files, tape, card, and diskette files. BEM EDT accesses only 
SAT library files. 


2. EDT supports variable-length and fixed-length records. BEM EDT supports 
only fixed-length records. 
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e Syntax conventions 


1. EDT uses a colon (:) as a column and line range separator, while BEM EDT 
uses a hyphen (-). 


Note: EDT lets you change the column and line range separator from the 
preset colon to another symbol via the @SET COLON=range- 
separator command. 


2. EDT indicates the start column of a found search string by an open bracket 
(1). BEM EDT uses a percent sign (%). EDT uses a closed bracket (]) to 
indicate the end of column of a found search string. BEM EDT has no special 
symbol for the end of column. 


3. EDT uses #Gn(x:y), where x:y denotes the column range to define a variable 
substring. BEM EDT uses #Gn(s,L), where s denotes the starting column and 
L denotes the length of the substring. 

4. EDT uses n(x:y) as the syntax for a line substring; BEM EDT uses n:x-y. 

5. The current line number and increment are not local for BEM EDT. 

6. EDT (using a free-form scan) recognizes as command lines only those lines 


whose first nonblank character is a command trigger (@). BEM EDT 
recognizes the command trigger only in column 1. 





7. EDT defaults to the PRINT option of the procedure file that called it, or to 
NOPRINT if it is called from the main work file. BEM EDT defaults to 
NOPRINT. EDT allows greater control and flexibility with the PRINT and 
NOPRINT options on the DO command. 


¢ Function key support 
EDT supports the following function keys: 


Fl 

F2 

F15 (EOF) 
F18 

F19 
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¢ BEM EDT commands not supported by EDT 


1. These commands have no equivalent function in EDT: 


@RSP 
@SET PAGE 


Note: Although EDT does not support RSP scanning of the spool file, you 
can use the interactive services DI SPL instead. You can also read 
spool files using EDT; however, you must know which spool file is to 
be retrieved before you can use this command. 


2. Models 10 through 20 have equivalent system commands that replace these 
BEM EDT commands: 
QUPPER 
@LOWER 
@HELP 
TYPE 


3. The EDT keyword KKEY has the same function as the BEM EDT DESEQ 
command, but is more thorough in syntax checking. 


¢ BEM features not provided by interactive services 
1. Idle terminal timeout and logoff 
2. Ability to limit command access based on user-id 
3. TTY support 


For further information on EDT, see the General Editor (EDT) Operating Guide, 
7004 4599. 


4.5.2. Interactive BASIC 


Interactive BASIC is functionally equivalent to BEM BASIC and can be run in either 

CDM or mixed mode. You may already be familiar with interactive BASIC, since it is 

supported on Series 90 for Releases 7.0.1 forward. To use interactive BASIC, log on to 
one of your models 10 through 20 workstations and enter the following command: 


BASIC 


When the message BASIC READY appears on your workstation screen, you can begin 
entering the BASIC statements for your program. Each line is checked for correct 
syntax as it is entered. 
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BEM BASIC and interactive BASIC are compatible with one exception: The 
workstation access method (WSAM), which is used by interactive BASIC, adds its own 
control character to a record for proper positioning. Therefore, when you create 
screens, you should output your screen with one PRINT command. If you build your 
screen with more than one PRINT command, WSAM will position the cursor in 
between the PRINT commands, which may affect your output. 

Here’s a summary of interactive BASIC features: 

¢ Workstation support 

¢ CDM 

e MIRAM data file support 

¢ Extended HELP message processing 


For more information on interactive BASIC, see the BASIC Programming Reference 
Manual, UP-9168. 


4.6. Basic Assembly Language (BAL) 


You can run your BAL programs in mixed mode on models 10 through 20 without 
making any changes. However, to convert to CDM mode, you must modify your source 
code and reassemble and relink your programs. You must also change any data files 
these programs use to MIRAM format. If your programs process SAM or DAM user 
disk labels, you must update them because MIRAM doesn’t support user disk labels. 


We provide a BAL macro converter (DTFCDI301) which converts file definition and 
1/O macros from DTF macro code to CDI macro code. DTFCDI301 flags statements 


that can’t be converted or that require special attention. It converts the following DTF 
macros: 


DTFCD DTFIS DTFNI 
DTFDA DTFMI DTFPR 
DTFIR DTFMT DTFSD 


7004 4631-000 











Language Products 


In addition, the following imperative and other macros associated with these DTF 
macros are also converted: 


CDIO FEOV POINTS SETF 
CLOSE GET PRIO SETFL 
CNTRL LBRET PRTOV SETL 
DPCA MTIO PUT SETP 
DTFDM NOTE READ SETS 
ENDFL OPEN RELSE TRUNC 
ESETL POINT SAMIO WRITE 


There are sufficient differences between DTF and CDI assembler specifications to 
preclude a one-for-one conversion approach. Therefore, we’ve provided the guidelines 
in 4.6.1 through 4.6.3 to help your conversion effort. 


4.6.1. BAL Migration Guidelines 


1. 
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User physical I/O programs that execute with the system access bit in the CCB 
turned off aren’t supported. This bit is reset by the CCB macro when the fourth 
positional parameter (error option) excludes an X‘08’ setting. If you want to 
continue to use these programs, you must modify them to turn on the system 
access bit. However, you should consider converting these programs to a higher 
level language. 


Programs that operate at the physical I/O level must not be dependent on the 
particular sequence of operations used by a particular channel. 


Programs should not use negative relocation for addressing unauthorized storage 
areas. 


Programs must be independent of the relations between instruction execution 
times, I/O data rates, access times, I/O command execution times, and timing 


facilities (including elapsed time values). 


Programs must not use Series 90 low order storage locations assigned specifically 
for system use. 


Programs must not depend on Series 90 machine dependent functions. 


The following Series 90 privileged instructions don’t exist on models 10 through 
20: 


a. SOFTSCOPE forward scan (SSFS) 
b. SOFTSCOPE reverse scan (SSRS) 


c. Load control storage (LCS) 
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8. Change any specific references to fields contained in DTF structures in the user 
region of your programs. 


9. Contingency routine addresses for EOFADDR and ERROR aren’t supported by 
CDM; access these addresses with inline code following imperative commands. 


4.6.2. DTF ISAM to CDI MIRAM Keyword Conversion 


Table 4-2 compares DIF keyword parameters and CDI keyword parameters. Look at 
this table first, and then at the conversion that follows it. In the conversion, a DTF 
ISAM file is converted to a CDI MIRAM file with a single key. Note that line sequence 
numbers are used for comparison between the DTF and CDI parameters. 


Table 4-2. Comparison of DTF and CDI Keyword Parameters 














Sequence DTF CDI 

Number Parameter DTF Description Parameter CDI Description 

1 ACCESS Specifies how the file is tobe © ACCESS Specifies how the file is to be 
shared shared 

2 BLKSIZE Block size calculated by BFSZ Buffer size calculated on 
(RECORD LENGTH + 5) x record and sector sizes as 
(NUMBER OF RECORDS PER defined for MIRAM files 
BLOCK) 

3 ERROR ERROR contingency routine No corresponding CDI 
address parameter 

4 INDAREA Main storage location for INDA Same function as in DTF 
index blocks during load mode 
operations, or for top index 
table during random retrieval 
or record insertion 

5 INDSIZE Length of index area INDS Length of index area 

6 IOAREA1 Location of I/O area IOA1 Location of I/O area 

7 IOROUT Type of file processing No corresponding CDI 

parameter 


—___—eeea————— Ohne 


410 


continued 
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Table 4-2. Comparison of DTF and CDI Keyword Parameters (cont.) 


Sequence 
Number 


DTF 
Parameter 


KEYARG 


KEYLEN 


DTF Description 


Program location for 
address/keys to effect 
record retrieval 


CDi 
Parameter 


KARG 


CDI Description 


Program location for 
address/keys to effect 
record retrieval 


Length and offset of record 


9-10 


11 


12 


13 


14 


15 


16 
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KEYLOC 


PCYLOFL 


RECFORM 


RECSIZE 


TYPEFLE 


VERIFY 


WORK1 


key 


Percentage of cylinder 
overflow 


Sequential/random access 


Specifies if output record 
parity is to be checked 


Location of the record work 


area 


No corresponding DTF 
parameter 


KEYn 
(LEN,LOC) 


RCFM 


RCSZ 


MODE 


VRFY 


WORK 


PROC 


Length and offset of record 
key 


No corresponding CDI 
parameter 


Record format 


Record format 


Maximum record length 


Maximum record length 
Sequential/random access 


Specifies if output record 
parity is to be checked 


Specifies that records will be 
processed in a work area 


instead of in a buffer 


Keyed/unkeyed processing 
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Here are the characteristics of the DT F ISAM file before conversion to MIRAM: 


DTFIS 


Parameter 


ACCESS 
BLKSIZE 
ERROR 
INDAREA 
INDSIZE 
IOAREA1 
IOROUT 
KEYARG 
KEYLEN 
KEYLOC 
PCYLOFL 
RECFORM 
RECSIZE 
TYPEFLE 
VERIFY 
WORK1 


Value 


EXC 

427 
errtn 
indx 

256 
newrec 
LOAD 
ssnno 

9 

39 

20 
FIXBLK 
80 
RANSEQ 
YES 
worka 


Sequence Number 


CoOnNoan»1hwhd rH 


16 


To convert the DTF ISAM file to a CDI MIRAM file with a single key, make the 
following changes: 


RIB 


Parameter 


ACCESS 
BFSZ 
INDA 
INDS 
IOA1 
KARG 
KEY1 
RCFM 
RCSZ 
MODE 
VRFY 
WORK 
PROC 
RETR 


Value 


EXC 
512 
indx 
256 
newrec 
ssnno 


(9,39,NDUP,NCHG) 


FIX 


Sequence Number 
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4.6.3. DTF to CDI Processing Considerations 
Here are some considerations when converting from DTF to CDI: 
1. Opening files 


To open a file in DTF, use: 
OPEN INP 

To open a file in CDI, use: 
OPEN INP, CINPRIB) 


You must supply the resource information block (RIB) name 


Language Products 


when you open a file 


using CDI. This sets up the file structure; otherwise, all defaults for the file 


structure are applied. 
2. Closing files 
To close a file in either DTF or CDI, use: 
CLOSE INP 
3. Sequential processing 
To sequentially process an ISAM file in DTF, use: 


SETL INP, BOF (This sets file at beginning.) 


To continue processing, use: 


GET INP,WORKA (This reads a record sequentially.) 


PUT INP,WORKA (This updates the record.) 


To terminate sequential processing, use: 


ESETL INP 


To sequentially process a MIRAM file, you must first be sure you are starting at 
the beginning of the file. If you have just issued the OPEN macro for that file, the 
current location is automatically set to the beginning of the file. If the file is 
already opened, use the following macro to set the current position to the 


beginning of the file: 


DMSEL INP, RECORD, BOF (The BOF option places you at the 


beginning of the file.) 
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To continue processing, use: 


DMINP INP,WORKA,,,SEQ (This reads a record sequentially.) 
DMUPD INP,WORKA (This updates the record.) 


Note: We supply the SEQ parameter in the DMINP macro to override the 
MODE=RAN parameter in line 14 of the RIB. (See Table 4-2.) 


Random processing 


To randomly process the file in DTF, specify the keyword parameter 
IOROUT=ADD or IOROUT=ADDRTER; then, use the following: 


WRITE INP,NEWKEY 


or (Use either macro to write a new record.) 
ADD INP 
WAITF (This delays processing until prior action 


terminates.) 
READ INP,KEY 
and (This retrieves record by location.) 


WAITF 





WRITE INP, KEY 
or (This rewrites the last record retrieved.) 
UPDT INP 
followed by: 
WAITF 


To randomly process a file in CDI, use: 


DMOUT INP,WORKA (This writes a new record.) 
DMINP INP,WORKA (This retrieves a record by key.) 
DMUPD INP,WORKA (This updates a record. RETR=MOD must be 


specified in the RIB macro.) 


DMDEL INP (This deletes a record.) 


4.6.4. Release 14 Control Structure Change Considerations 
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Many OS/3 data structures were modified in Release 14 to support expanded memory 
addressing required for the model 50. Because of this change, your existing BAL 
programs that use the GETINF macro to access job preamble, task control block 
(TCB), or system information block (SIB) information must be modified and then 
reassembled. 
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Changes made to the job preamble, TCB, and SIB structures are indicated below. 
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Corrections must be made to the GETINF macro number-of-bytes and displacement 
parameters to reflect these changes. In addition, workarea buffer space may need to 
be expanded. 


Field 


Job Preamble 


Task 


JPSLTSK 
JPSMAXSZ 
JPSMHI 
JPSMLO 
JPSNAM 
JPSNEWRA 
JPSNEWSZ 
JPSOCLNG 
JPSOPRI 
JPSORGSZ 
JPSSCHBA 
JP$SIZ 


Control Block 
JTSACT 
JTSBIMFR 
JTSECB 
JTSICCNT 
JTSJAFLG 


JTSKEY 
JTSLNK 
JTSNXTCB 
JTSPCIC 
JTSRLNK 
JT$SCID 
JTSTID 


Description of Change 


Data no longer in top byte 


Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Moved to allow room for 
Expanded from hal f-word 
Expanded from hal f-word 
No longer first byte of 
No longer first byte of 
Expanded from hal f-word 
Expanded from hal f-word 


to 
to 
to 
Hi 
to 
to 
an 
an 
to 
to 


full-word 
full-word 
full-word 

and Low 
full-word 
full -word 
address field 
address field 
full -word 
full-word 


JPSTYP added to accommodate relocated type field 


Data no longer in first byte of an address field 
Data no longer in first byte of an address field 
Data no longer in first byte of an address field 
No longer the first byte of an address field 


No longer the first byte of JT$ACT (The number of 


accounting table pubs) 


No longer the first byte of an address field 
Data no longer in first byte of an address field 
Data no longer in first byte of an address field 
Data no longer in first byte of an address field 
Data no longer .in first byte of an address field 
No longer the first byte of an address field 
No longer the first byte of an address field 


System Information Block 
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SBSAVL 
SBSECOV 
SBSELTA 
SBSERLG 
SBSHASPE 
SBSHCOV 
SBSIMVAD 
SBSIMVJB 
SBSIMVJS 
SBSIMVRS 
SBSIMVST 
SBSIMVSZ 
SB$IOLOC 
SB$10Q 
SBSISFLG 
SBSJQMIN 
SBSLFREE 
SBSLKTAB 


Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 
Expanded from hal f-word 


to 
to 
to 
to 
to 
to 
to 
to 
to 
to 
to 
to 
to 
to 


full-word 
full-word 
full -word 
full -word 
full-word 
full -word 
full -word 
full -word 
full -word 
full-word 
full-word 
full-word 
full-word 
full-word 


No longer the first byte of an address field 
Expanded from half-word to full-word 

No longer has bits in the top byte 

Expanded from half-word to full-word 
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Field Description of Change 
System Information Block (cont.) 

SBSMADR Expanded from half-word to full-word 
SBSMCOV Expanded from half-word to full-word 
SBSMHI Expanded from half-word to full-word 
SBSMLO Expanded from half-word to full-word 
SBSNEWJB Expanded from half-word to full-word 
SBSNEWSZ Expanded from half-word to full-word 
SBSPCOV Expanded from half-word to fult-word 
SBSRCAD No longer has bits in top byte 

SBSRCT Expanded from half-word to full-word 
SBSRELOC Expanded from half-word to full-word 
SBSRFRSH Expanded from half-word to full-word 
SBSSPE Expanded from half-word to full-word 
SBSSQMAP Expanded from half-word to full-word 
SBSSYM Expanded from half-word to full-word 
SBS$TIMSB Expanded from half-word to full-word 


4.7. ESCORT Programming Language 
The ESCORT programming language uses CDM interfaces and is completely 


interchangeable between Series 90 and the models 10 through 20. You don’t have to 


make any changes to your ESCORT programs or data files to use them on models 10 
through 20. 


4.8. Sorting 


Models 10 through 20 support the sort/merge and SORTS programs as follows: 





¢  Sort/Merge 


All Series 90 sort/merge job control streams are fully compatible with models 10 
through 20. In addition, models 10 through 20 sort/merge programs support 
MIRAM files in both BDM and CDM mode. In a mixed mode environment, when 
there is tape input, disk output, and no SORT FILTYPE parameter (to explicitly 
declare the disk output file type), the output file is a MIRAM file. (Ina BDM-only 
environment, the output file is a SAM file.) 


¢ SORT3 


All Series 90 SORTS job control streams are fully compatible with models 10 
through 20. SORT3 supports MIRAM files in both BDM and CDM mode. Ina 


mixed-mode environment, SORT3 produces MIRAM files as output regardless of 
input file type. 
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Section 5 
ICAM Migration 


5.1. General 


Most Series 90 integrated communications access method (ICAM) programs are 
source code compatible with models 10 through 20. Therefore, you can run most of 
your communications user programs (CUPs) on models 10 through 20 without change. 
But ICAM has been enhanced to include many new features since OS/3 Release 8.1. 
These features include global network support, interactive services interface (DMI), 
and new workstation support. To use these new ICAM features in CUPs that 
currently run under BDM, you must convert those CUPs to use CDM and regenerate 
your ICAM network to define the communications (channel and line) network 
configuration for the models 10 through 20. 


In this section, we'll tell you how to upgrade your existing CUPs to models 10 through 
20. It’s really a very simple process. In most cases, all you have to do is recompile your 
CUPs on models 10 through 20, just as you previously did on your Series 90 system. 
The only exceptions to this are communications physical interface (CPI) user 
programs, which require some additional changes. 


5.2. Communications User Programs (CUPs) 


5.2.1. COBOL CUPs 


Series 90 COBOL CUPs are source compatible with models 10 through 20 and can run 
in a mixed-mode data management environment without change. To use CDM 


interfaces for data files, however, you must recompile your COBOL CUPs on models 
10 through 20. 


5.2.2. RPG Il CUPs 


Series 90 RPG II CUPs are source compatible with models 10 through 20 and can run 
in a mixed-mode environment without change. To use CDM interfaces for data files, 
however, you must recompile your RPG II CUPs on models 10 through 20. 
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5.2.3. Assembler CUPs 


Most Series 90 Assembler CUPs are source compatible with models 10 through 20 and 
can run in a mixed-mode environment without change. To use CDM interfaces for 
data files, however, you must convert and reassemble your Assembler programs on 
models 10 through 20. See 4.6 for details on converting Assembler programs to CDM 
mode. 


5.3. Network Definition 


ICAM lets you: 

¢ Input data from a network of remote terminals into a program for processing 
¢ Distribute messages to the terminals within the network 

¢ Transfer messages from terminal to terminal 


Generally, you have only one network defined and operating on your system. 
However, ICAM permits you to define several distinct networks and to have these 
networks operating simultaneously. You define each network during SYSGEN by 
submitting a set of macros that defines the terminals, lines, buffers, and queues for 
that network. In addition, you must specify which of the four available 
communications interfaces each network is to use. A terminal can be included in more 
than one network definition; however, only one network can use the terminal at a 
time. 


The models 10 through 20 communications hardware configuration supports up to 2 
channels with 14 lines (ports) on each channel. Your ICAM network generation must 
include the physical channel and line specification in the LINE and CACH macros. 


5.4. Communications Physical Interface (CPI) 


5-2 


Guidelines 


If you are a communications physical interface (CPI) user, you are totally responsible 
for all single line communications adapter (SLCA) initialization and control 
procedures. Therefore, you must make some changes to your CPI user programs when 
you migrate to models 10 through 20. The most significant changes are summarized 
here: 


¢ The communications physical input/output control program (CPIOCP) packet size 
has been increased to 14 full words (including sense bytes for the SLCA). 


¢ The port control word must specify the character detect. and character 
interpretation tables as table 1 (bytes 2 and 3, bit 1=0). 
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¢ The SLCA buffer size must be specified in the TN#PBLTH field of the CPIOCP at 
line request time. The valid range is 32-256 in decimal. If buffer toggling is 
required, the line buffer size must be an even multiple of the SLCA buffer size. 


* To set asynchronous line speeds for models 10 through 20 single line 
communications adapter port control word, see Table 5-1. 


Table 5-1. Port Control Word Settings for Models 10 through 20 Asynchronous Line Speeds 









Asynchronous Speed 
(Bits per Second) 





Not used (inval jd*) 
58 
75 
118 
134 
158 
308 
600 
900 
1200 
1800 
2400 
3600 
4800 
7200 
9620 
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*Results in program alert sense and unit check status 


¢ The channel number and SLCA number must be set in the CPIOCP for every 
request, including a network request. The channel number must be 0D,, or OF ,,; 
the SLCA number must be in the range 01,, to OF 1,. 

¢ To retrieve the data in the SLCA buffer when a CPIOCP input time-out error 
occurs, specify the line procedure timer value in the port control word. See the 
Integrated Communications Access Method (ICAM) Communications Physical 
Interface (CPI) Programming Guide, UP-9746. 


¢ The turn-off command does not provide an immediate status. The I/O completion 
interrupt must be awaited. 
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¢ Data chain users must set up the first two CPIOCP packets (including the first 
data chain address) prior to the first CCR call. Failure to comply with this 
requirement causes a system error. 


® Invalid packet chaining links cause system errors. 


¢ If buffer toggling is required, TN#PESO (error schedule only) must not be 
specified in the TN#PFLGS field of the CPIOCP. If specified, return of the 
CPIOCP buffer completion interrupt is prevented. 


¢ Ifbuffer toggling is required, all CPIOCPs must specify continuation (TN#PFS 
and TN#PFL=0) after the first CPIOCP. 


For network generation: 


¢  Ifyour line handler uses half-duplex protocols, you must specify half-duplex in 
the LINE macro and CACH statement. All ICAM line handlers use half-duplex 
except NTR, UDLC-ABM, and PDN level 2X.25. 


e  Ifyour line handler uses full-duplex protocols, you must specify full-duplex in the 
LINE macro and CACH statement. 


e Ifnecessary, you can use full-duplex modems and lines with half-duplex line 
handler protocols. 


5.5. Remote Workstation Guidelines 


If you currently are running on Release 8.2 or earlier, you must now specify the 
LINKPAK and UDUCT parameters on the BUFFERS network definition statement. 
Also, you must specify REMWORKSTATION in the I/OGEN phase of system 
generation. 


5.6. Terminals Emulating Workstations 


You must specify REMWORKSTATION in the I/OGEN phase of system generation if 
terminals are to be in session with interactive services. (See the Models 8-20 
Installation Guide, 7004 5505.) 


5.7. ICAM Trace 


Starting with Release 8.2, ICAM trace is performed by the ITF symbiont. The 
TRACEMAX network definition parameter is no longer used. See the Integrated 
Communications Access Method (ICAM) Utilities Programming Guide, 7004 4565, for 
a description of the ITF symbiont. 
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® 5.8. ICAM DT Trace 


Starting with Release 12.0, ICAM provides a device trace that is capable of tracing the 
entire input and output as well as the physical I/O data structures for a given physical 
device. See the Integrated Communications Access Method (ICAM) Utilities 
Programming Guide, 7004 4565, for a description of the DT symbiont. 


5.9. ICAM Operator Communications 


Starting with Release 8.2, the network name is referenced in ICAM messages and 
responses instead of the user’s job slot number. 
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Section 6 
Data Base Products 


6.1. Information Management System (IMS) 


There are two considerations: 


1. Single-thread IMS is not supported on the models 10 through 20 and must be 
converted to multithread IMS. 


2. Action programs should be converted from BDM to CDM to take advantage of 
CDM facilities. 


6.1.1. Conversion to Multithread IMS 


On your Series 90 system, you could generate two types of information management 
systems: 


1. Single-thread IMS 


Only one action is processed at a time, but actions from different transactions 
may be interspersed. 


2. Multithread IMS 

Actions are processed concurrently for different transactions. 
If you are currently using multithread IMS, your existing Series 90 IMS systems can 
run on models 10 through 20. If you are currently using single-thread IMS, you must 
convert to multithread because single-thread IMS is not supported on models 10 
through 20. 
To convert from single-thread to multithread IMS, you must: 
¢ Change IMS configuration parameters not supported by models 10 through 20 


¢ Change the associated job control streams 
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In the following subsections, we show you which IMS configuration parameters you @ 
must change when moving to a multithread environment. We also provide a sample 

job control stream so you can see how to execute online IMS on models 10 through 20. 

However, remember that when you upgrade to multithread IMS, you should review 

the overall logic and design of your action programs. You can then take advantage of 

multithread to improve the efficiency of your IMS system. 


Table 6-1 shows which IMS configuration parameters are supported on models 10 
through 20 for OS/3 Releases 6.1.2 forward. To determine if a parameter is supported 
for a given release, look for an X in the appropiate release column. (An X indicates 
that the parameter is supported, and if it is supported for IMS single-thread or 
multithread.) If a parameter from your current release is not supported on the release 
to which you are migrating, you must remove that parameter from your current 
configuration before you migrate to the new release. For a complete listing of 
parameter definitions and values, refer to the Information Management System (IMS) 
System Support Functions Programming Guide, UP-11907. 
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Table 6-1. IMS Configuration Parameters 



























Release 8.0/8.2/ 


Release 10/11/ 





























Release 6.1.2 |Release 7.0/7.1 9/18 12/13/14 
Single- |Multi- |Single- |Multi- |Single- |Multi- | Multithread 
Section Parameter |Thread |thread |Thread |thread |Thread | thread only 
NETWORK X 
KATAKANA X 
PRCSNUM xX 
UNSOL xX 
STATUMSG X 
GENERAL INBUFSIZ xX 
DDPBUF X 
DDPSESS Xx 
TRANLEN xX 
OPTIONS BASIC 
DMS x xX xX Xx X 
FASTLOAD X xX xX x x 
INTLIST x xX X xX 
MSGCLR x xX xX 
MSGPOS X X X 
OPCOM xX xX x x 
RECLOCK x xX 
RESFMT x xX X 
RESMEM X 
SFS X xX X X 
STATS xX X X 
TERMINAL STATUSMSG X 
UNATTEND X 
FILE FILETYPE X xX 
CAFILE xX X 
CUPDATE X X 
DELETP X 
PKEY X 
DTF X X 
RIB X 
ie 
TRANSACT | LOCAP Xx 
UNDEF Xx 
ACTION EXPIRTME X 
FCCEDIT x 
LANGUAGE | lex-name xX 
lLang-name x 
LOCAP x 
Xx 
DRCRDMGT 
TIMEOUTS INTRFQCY x 
ACTION xX 
STATUS X 
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6.1.2. Conversion of IMS Programs to CDM 


We recommend that you convert your IMS action programs to CDM so you can take 
advantage of the facilities, such as enhanced disk file sharing, that are provided by 
CDM. Note that IMS does not support mixed mode. Consequently, if you decide to use 
CDM, you must convert all your programs. 


To convert your IMS systems from BDM to CDM, you must: 
1. Accept the default CDM=YES in IMSCONF. 


2. Change data management parameters in the FILE section of the IMS 
configurator to support CDM (described in 6.1.1.). 


3. Convert your data files to MIRAM format (described in Section 3). 
4. Recompile your action programs. 


The following subsections describe the changes you must make to IMSCONF and to 
your IMS action programs. 


IMSCONF 


The IMSCONF job control procedure (jproc) generates and executes control streams to 
perform system generation for single-thread and multithread IMS systems. Use the 
following IMSCONF parameter to select the data management mode your IMS system 
uses: 


CDM=[ YES 
{0 | 
To generate an IMS system using CDM, accept the default CDM=YES. This 
parameter replaces the CDI parameter used on Series 90 Release 7.1. Note that you 
must specify CDM=NO to run IMS.in BDM mode; if you specify this parameter, you 


must also specify DUGTMODE=MIXED when you generate your supervisor during 
SYSGEN. 
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An IMSCOMF feature, the internal statistical file (STATFIL), records data during 
online processing. STATFIL is a sequential unkeyed MIRAM file with variable-length 
records. There are two ways you can allocate STATFIL: 

e Specify the STATFIL parameter in IMSCONF. 

¢ Specify a user file label in the IMSFIL parameter in IMSCONF. 


If you don’t want to allocate STATFIL, specify NO in the IMSCONF INIT 
subparameter. 


Table 6-2 lists new IMSCONF parameters for Releases 6.1.2 forward. An X indicates 
that the parameter is supported for the specified release; N/A means not applicable. 


Table 6-2. New IMSCONF Parameters 

















Release 
IMSCONF Parameter | 6.1.2 | 7.@.1/7.1 | 8.0/8.2/9/18 11/12/13/14 
CDI x JA N/A 


CDM N/A x 
STATFIL N/A xX 
INIT=cyl-statfil xX 
ZCNF=ST 


ZCNF=MT 


Action Programs 


To migrate your COBOL, RPG II, or BAL action programs, you need not recompile 
those programs on models 10 through 20. If you are converting an ANSI 1968 COBOL 
action program to ANSI 1974 COBOL, you may want to compile the program as 
reentrant code and configure the program as TYPE=REN (reentrant) instead of 
TYPE=SHR. If you are converting to ANSI 1985 COBOL, you cannot configure the 
program as TYPE=SHR; you must configure the program as TYPE=SER (serial 
reusable) or TYPE=REN (reentrant). 


6.2. Data Base Management System (DMS) 


You must recompile the device media control language (DMCL) for the data dictionary 
data base and the user production data base. You need not recompile the DMS 
application programs or regenerate the data dictionary. 
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Section / 
System 80 Migration Overview 


7.1. General Considerations 


Making the transition to the models 10 through 20 should be relatively easy and 
trouble free. Models 10 through 20 provide both software and hardware compatibility 
with your present system; they also offer greater processing power and more main 
storage than your present system. You can move all your programs and data files to 
the models 10 through 20 unchanged. You can also take most of your peripherals with 
you when you migrate to the models 10 through 20. 


The following lists some of the areas that may be of concern to you when migrating to 
the models 10 through 20: 


¢ Disk support for SYSRES and data files must be considered. Not all disks 
supported on the models 10 through 20 can be used as SYSRES. Capacity and 
sizing must be taken into consideration. Subsection 3.4 lists the hardware devices 
supported on the models 10 through 20 and identifies which disk units cannot be 
used as SYSRES devices. Additional information is presented in Section 8. 


e Differences in channel addresses between your present system and the models 10 
through 20 may require you to make changes to your job control streams. 
Subsection 8.3 provides information concerning the differences in channel 
addresses for the various System 80 models. 


¢ The need to generate a supervisor or to define a different I/O configuration 
depends on the differences between your current system configuration and the 
configuration of the system to which you are migrating. Information concerning 
system generation is described in Section 8. 


¢ Most of your program files (source, object, and load) and all of your data files 
(including IMS and DMS) can be ported without change. You won’t have to pass 
your program or files through transcription or conversion utilities. Information 
about language product migration is presented in Section 10. Migration 
information concerning data base products is presented in Section 12. 
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7.2. Migration Planning and Execution 





Planning and executing your migration to the models 10 through 20 is essentially the 
same as that described in Section 1. Refer to the information in Section 1 to help you 
put together a migration plan. 


7.2.1. Software Compatibility 
You can move most of your programs (source, object, and load), without change, to the 
models 10 through 20. However, see Sections 10 and 12 for information about 


required changes to certain programs. 


All of your data files can be moved, without change, to the models 10 through 20. 


7.2.2. Hardware Compatibility 


You can take most of your present system peripherals with you when you migrate to 
the models 10 through 20. See 3.4 for a list of the peripherals that are supported by 
the models 10 through 20. 
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section 8 
System Generation 


8.1. Basic Supervisor 


A basic supervisor, SY$BAS, is delivered to you as part of the system control software 
for models 10 through 20. SY$BAS eliminates the need to perform a SYSGEN 
operation unless you have a specific reason to do so. If you require features not 
supplied by SY$BAS, you must generate a supervisor tailored to your needs. For a 
complete list of SY$BAS, you must refer to the Models 8-20 Installation Guide, 

7004 5505. 


8.2. Supervisor Configuration 


You perform system generation (SYSGEN) on models 10 through 20 just as you do on 
your present system. Models 10 through 20 support the SYSGEN dialog, which lets 
you generate supervisors interactively at a workstation. Or, if you prefer, you can use 
an editor to create a SYSGEN source module. Regardless of the method you use, all 
SYSGEN procedures are fully compatible between systems. The Models 8-20 
Installation Guide, 7004 5505, describes the procedures for generating a supervisor 
either interactively or in a batch mode. 


See Table 2-1 for a list of the SUPGEN parameters that are new or whose default 
values have been changed. 


8.3. 1/O Configuration 


Models 10 through 20 support channel addresses that are different from those 
supported on your present system. Table 8-1 shows the channel addresses that are 
supported for System 80 models 3 through 6, 7E, 8, and 10 through 20. If you have job 
control streams that use explicit channel addresses on the DVC statement, you may 
need to change the DVC statements. Use the channel address information in Table 8-1 
to make the necessary changes. 
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Table 8-1. Supported Channel Addresses 


System 8@ Model | Supported Channel Address 





3 through 6 1 through 4 
7E @ through 2 
8 @ through 3, 6, 7, and 12 through 15 


Channels 1 through 3, 6, and 7 are selector channels. 
Channel 3 has the highest priority. 


1@ through 28 1 through 6, and 12 through 15 
Channels 1 through 6 are selector channels. 
Channel 1 has the highest priority. 


8.4. 8418 Disk Support 


The 8418 disk cannot be used as a SYSRES device on models 10 through 20; the disk’s 
relatively small capacity can cause sizing problems. The addition of new products to 
OS/3, as well as the increasing size of existing products, makes it difficult to fit 
everything onto an 8418 disk. By not allowing the 8418 disk to be used as a SYSRES 
device, we’ve eliminated potential sizing problems. 


8.5. Plateau Control 


Models 10 through 20 use plateau control. It provides coordination between the 
different levels of the hardware, software, microcode, and microcode products. See the 
Release 14 System Release Announcement, 7004 1991, for additional information on 
plateau control. 
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Section 9 
Data Management 


9.1. Environments 


Models 10 through 20 are designed to operate primarily under consolidated data 
management (CDM). They also support basic data management (BDM). 


On models 10 through 20, you choose your data management environment during 
SYSGEN by specifying one of two values for the DMGTMODE parameter: 


MIXED 
DMGTMODE= 


CDI 


If you specify DUGTMODE=CDI, models 10 through 20 support CDM only. If you 
accept the default DAGTMODE=MIXED, models 10 through 20 support BDM and 
CDM. 


The data management environment that you select on models 10 through 20 is 
determined by the environment on your present system. If you are currently running 
in a mixed environment, specify DMGTMODE=MIXED. 


If you are currently running in a CDM environment, specify DMUGTMODE=CDI. Note 
that if you are moving from a model 3 through 6, you specify CDI because that is the 
environment you are currently using. 


9.2. Disk File Sharing 


The FILELOCK SYSGEN parameter specification on models 10 through 20 is 
determined by the specification on your present system. 


If you are currently using FILELOCK=YES, use this specification on models 10 
through 20. 


If you are currently using FILELOCK=SHARE, use this specification on models 10 
through 20. Note that if you are moving from models 3 through 6, you should specify 
SHARE because this is the only option available on models 3 through 6. 
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9.3. Disk Cache Facility 


The disk cache facility used on models 10 through 20 is the same as that used on 
models 7E and 8. If you are moving from models 3 through 6, you should be aware of 
the following additional facilities that are supported on models 10 through 20: 


Dynamic resegmenting of the cache buffer 

Disk cache employs the concept of a segment size where the cache buffer is 
divided into equal sized segments. You can dynamically resegment your cache 
buffer on models 10 through 20 via a console command. On models 4 through 6, 
you can generate your system with a segment size you specify, but you cannot 
dynamically resegment. 

Dynamic removal and activation of devices 

On models 10 through 20 you can dynamically remove and activate devices from 
cache via console commands (Release 11 forward). On models 4 through 6, you 
must do this statically at system generation time. 

Statistics by device address 

Models 10 through 20 support statistics by device address (Release 11 forward). 
Larger maximum buffer size 


The maximum cache buffer size has been increased to 8 MB (Release 11 forward). 


Selective caching of files 


You can designate on models 10 and 20 (Release 11 forward) and on the model 15 
(Release 12 forward) that specific files be cached or not cached. This is an 
extremely useful tool for tuning your system because it lets you control which 
files use the cache. 


If during the migration period you share a device between two processors, you should 
be aware of the following considerations: 


92 


Only one system should be writing to a disk device. If both are writing, you run 
the risk of overwriting a format label or data. 


Do not cache the reader if one system is writing and the other is reading. If you 
do, the reader could get old information that happens to be in its cache but has 


since been updated by the writer. Use the CACHE IOGEN parameter or the 
cache console command to remove a device from cache. 
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9.4. Screen Formats 


Starting with Release 8.0, a new internal format has been used for screens. A 
conversion utility, SFCVR, was provided to convert screens from the old format to the 
new format. If you have screens that were created in Release 7.0 or 7.1, we 
recommend that you use SFCVR to convert them. If you do not, performance will 
suffer because they will be dynamically converted each time they are used. Refer to 
3.11 for additional information on SFCVR. 
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section 10 
Language Products 


When you migrate to models 10 through 20, you can move your COBOL, RPG II, 
FORTRAN IV, Sort/Merge and SORT3 programs to the new system without making 
any changes to them. Any migration considerations are related to the conversion from 
BDM to CDM, which, as previously mentioned, is not required. This is something you 
have already done. 


10.1. BAL Considerations 


OS/3 was modified in Release 14 to support the increased memory capacity provided 
by the model 50 processor. Therefore, some existing assembly language (BAL) 
applications (those that access or modify OS/3 internal data structures) may need to 
be modified and then reassembled. See 4.6.4 for additional information. 


10.2 LINC Il Considerations 


Only LINC™ II level 14.4 or later versions can be used on Release 14. Earlier versions 
of LINC will not run on Release 14. LINC level 14.4, however, can be used with prior 
OS/3 releases. 


10.3 C Program Considerations 


C programs using the tmpname function must be relinked on Release 14 due to the 
modified fields within the job preamble. 


LINC is a trademark of Unisys corporation. 
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Section 11 
ICAM Migration 


11.1. General 


The key factor for ICAM migration is your current software release level. This 
determines what changes you must make when you move to models 10 through 20. 
The following subsections identify at what release level you must make these changes. 


11.2. Communications User Programs (CUPs) 


Your COBOL, RPG II, and BAL CUPs will run unchanged on models 10 through 20 
(OS/3 Release 14). If you are currently running on Release 8.1 or earlier and want to 
convert to CDM, you must recompile your COBOL and RPG II CUPs. If you have BAL 
CUPs, you must make the necessary source changes and then reassemble the CUPs. 
Refer to 5.2 for detailed information. 


11.3. Network Definition 


The models 10 through 20 communications hardware configuration supports up to 2 
channels with 14 lines (ports) on each channel. Your ICAM network generation must 
include the physical channel and line specification in the LINE and CACH macros. 


11.4. Communications Physical Interface (CPI) 
Guidelines 


If you are running on Release 8.1 or earlier, you must modify your CPI programs. See 
5.4 for detailed information. 


11.5. Remote Workstation Guidelines 


If you are running on Release 8.2 or earlier, you must now specify the LINKPAK and 
UDUCT parameters on the BUFFERS network definition statement. Also, you must 
specify REMWORKSTATION in the I/OGEN phase of system generation. 
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11.6. Terminals Emulating Workstations 


You must specify REMWORKSTATION in the I/OGEN phase of system generation if 
terminals are to be in session with interactive services. 


11.7. ICAM Trace 


Starting with Release 8.2, ICAM trace is performed by the ITF symbiont. The 
TRACEMAX network definition parameter is no longer used. See the Integrated 
Communications Access Method (ICAM) Utilities Programming Guide, 7004 4565, for 
a description of the ITF symbiont. 


11.8. ICAM DT Trace 


Starting with Release 12.0, ICAM provides a device trace that is capable of tracing the 
entire input and output as the physical I/O data structures for a given physical device. 
See the Integrated Communications Access Method (ICAM) Utilities Programming 
Guide, 7004 4565, for a description of the DT symbiont. 


11.9. ICAM Operator Communications 


Starting with Release 8.2, the network name is referenced in ICAM messages and 
responses instead of the user’s job slot number. 
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Section 12 
Data Base Products 


12.1. Information Management System (IMS) 


If you have configured your present system to operate in a mixed data management 

(CDM) environment, you must configure IMS to use the environment that applies to 
it. You specify this with the IMS CDM configuration parameter. CDM=YES (default) 
specifies CDM; CDOM=NO specifies BDM. 


The models 10 through 20 do not support single-thread IMS. You must convert any 
single-thread IMS systems to multithread. See 6.1.1 for IMS conversion details. 


You should also consider that, starting with Release 10.0, COBOL action programs 
can be configured as reentrant (shareable). 


12.2. Data Base Management System (DMS) 


All device media control language (DMCL) modules must be recompiled unless you 
are moving to Release 14 from Release 11, 12, or 13. Although not required, it is 
advisable to recompile your subschemas under the same situation because of an 
internal performance improvement that was introduced with Release 11. 
There have been many DMS enhancements introduced since Release 8.1: 
* Record indexing 

- Indexed location mode (8.1 SE) 

- Indexes available with any location mode (10) 

- Number of index keys increased to 32 per record type (10) 

- Manual insertion (optional) indexes (12) 

- DBRIND utility (index reorganization) (13) 
* DBMON run-time monitor and performance tuning aid 


= Online mode (10 SE) 


- Study mode and print utility (12) 
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¢ DBMS run-time 

- Unsolicited commands (10 SE and 12) 

- Log departs (10 SE and 12) 

- Log conflicts (10 SE and 12) 

- Suppress subschema date/time check at DMCL level (12) 

- Multiple DBMSs (13) 

- Page size granularity reduced to 512 bytes from 2K bytes (13) 
e¢ DML verb 

- Long (30-character) data names (10) 

- Range option for format 6 find/fetch (10) 

- DMLP copy facility (10 and 13) 

-  Find/fetch/keep exclusive and conditional forms (10) 


-  Find/fetch format 1 optional record name (11) 





- | Move access to owner, next, and prior pointers (12) 
e Journal files 

- Flexible assignment of journal files to DMCLs (9) 

- Disk journals extended over session (9) 

- Journal tape drives can be assigned dynamically (13) 
© Data dictionary 

- Multiple schemas per data dictionary (9) 

- Resizing (unload/reload) utilities (10) 

- DDL delete utilities (10 and 12) 

- List utility (13) 
¢ Other utilities 

- DBDUM tape block numbers (10 SE) 


-  DBINT logical QBL scratching (11) 
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12.3. TPS and TIP/30 Considerations 


You may wish to move to the Transaction Platform System (TPS™). TPS provides a 
consistent platform for all transaction processing. It is a fully functional subset of the 


very successful TIP/30 transaction processing software from Allinson-Ross 
corporation. 


Note: Only TIP/30 Version 5.0 (or later versions) can be used on Release 14. 
Earlier versions of TIP/30 will not run on Release 14. 


TPS is a trademark of Unisys Corporation. 
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